home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / doc / clue.tex / node188_mn.html < prev    next >
Text File  |  1989-07-12  |  6KB  |  136 lines
  1.  
  2. <H3><A ID="SECTION005311100000000000000"><tex2html_anchor_invisible_mark></A> <A ID="ch:roots"><tex2html_anchor_mark></A><BR>
  3. Roots
  4. </H3><#5231#>
  5.            
  6.       
  7.  
  8. All of the contacts belonging to a <#2586#><TT>contact-display</TT><#2586#> form a set of
  9. hierarchies. The root of each hierarchy is a special type of composite contact
  10. referred to as a <#2587#><B>root</B><#2587#><A ID="2588"><tex2html_anchor_invisible_mark></A>.
  11.  
  12. <P>
  13. <#4700#>
  14. <#4432#><FONT SIZE="+1"><#2589#><B>root Class</B><#2589#></FONT><#4432#> 
  15. <A ID="2590"><tex2html_anchor_invisible_mark></A>
  16. <DIV class="RIGHT">
  17. <tex2html_image_mark>#tex2html_wrap_inline10260#
  18. </DIV><#4700#>
  19.  
  20. <P>
  21. <DIV class="RIGHT">
  22. <tex2html_image_mark>#tex2html_wrap_inline10262#
  23. </DIV>
  24.  
  25. <P>
  26. All of the contacts descended from a <#2605#><TT>root</TT><#2605#> appear on the same screen of
  27. the <#2606#><TT>contact-display</TT><#2606#>. A <#2607#><TT>root</TT><#2607#> represents a display screen in
  28. two ways. First, a <#2608#><TT>root</TT><#2608#> typically corresponds to the root window of the
  29. screen and inherits all of its properties<A NAME="tex2html303" HREF="#footfnm1" TARGET="footer"><SUP>50.1</SUP></A>.  
  30. Input received by a root window
  31. will be dispatched to its <#2610#><TT>root</TT><#2610#> contact. Second, the  <#2611#><TT>xlib:screen</TT><#2611#> object
  32. may be accessed as a slot of the <#2612#><TT>root</TT><#2612#>.
  33.  
  34. <P>
  35. The set of <#2613#><TT>root</TT><#2613#> objects belonging to a <#2614#><TT>contact-display</TT><#2614#> is
  36. created
  37. automatically when the <#2615#><TT>contact-display</TT><#2615#> itself is created, and is never
  38. subsequently modified. Each <#2616#><TT>contact-display</TT><#2616#> has a default root which may
  39. be used as the default parent of newly-created contacts (see
  40. <#2617#><TT>make-contact</TT><#2617#>, Section~<A HREF=<tex2html_cr_mark>#ch:creation#2618><tex2html_cr_mark></A>).
  41. <A ID="2619"><tex2html_anchor_invisible_mark></A><A ID="2620"><tex2html_anchor_invisible_mark></A>
  42. The default
  43. root is typically determined by the <#2621#><TT>:default-screen</TT><#2621#> argument to
  44. <#2622#><TT>open-contact-display</TT><#2622#><A ID="2623"><tex2html_anchor_invisible_mark></A>.
  45. Alternatively, the default root may be inquired or modified using the
  46. <#2624#><TT>display-root</TT><#2624#> function.
  47.  
  48. <P>
  49. <#4701#>
  50. <#4436#><FONT SIZE="+1"><#2625#><B>display-root Function, contact-display</B><#2625#></FONT><#4436#>
  51. <A ID="2626"><tex2html_anchor_invisible_mark></A>
  52. <A ID="2627"><tex2html_anchor_invisible_mark></A>
  53. <DIV class="RIGHT">
  54. <tex2html_image_mark>#tex2html_wrap_inline10264#
  55. </DIV><#4701#>
  56.  
  57. <P>
  58. <DIV class="RIGHT">
  59. <tex2html_image_mark>#tex2html_wrap_inline10267#
  60. </DIV>
  61.  
  62. <P>
  63. <#4702#>
  64. <#4439#><FONT SIZE="+1"><#2645#><B>display-root-list Function, contact-display</B><#2645#></FONT><#4439#>
  65. <A ID="2646"><tex2html_anchor_invisible_mark></A>
  66. <A ID="2647"><tex2html_anchor_invisible_mark></A>
  67. <DIV class="RIGHT">
  68. <tex2html_image_mark>#tex2html_wrap_inline10268#
  69. </DIV><#4702#>
  70.  
  71. <P>
  72. <DIV class="RIGHT">
  73. <tex2html_image_mark>#tex2html_wrap_inline10271#
  74. </DIV>
  75.  
  76. <P>
  77. <#4703#>
  78. <#4442#><FONT SIZE="+1"><#2659#><B>contact-root Function, contact</B><#2659#></FONT><#4442#>
  79. <A ID="2660"><tex2html_anchor_invisible_mark></A>
  80. <A ID="2661"><tex2html_anchor_invisible_mark></A>
  81. <DIV class="RIGHT">
  82. <tex2html_image_mark>#tex2html_wrap_inline10272#
  83. </DIV><#4703#>
  84.  
  85. <P>
  86. <#4704#>
  87. <#4444#><FONT SIZE="+1"><#2670#><B>contact-screen Function, contact</B><#2670#></FONT><#4444#>
  88. <A ID="2671"><tex2html_anchor_invisible_mark></A>
  89. <A ID="2672"><tex2html_anchor_invisible_mark></A>
  90. <DIV class="RIGHT">
  91. <tex2html_image_mark>#tex2html_wrap_inline10275#
  92. </DIV><#4704#>
  93.  
  94. <P>
  95. Many applications will neither be aware of <#2681#><TT>root</TT><#2681#>s nor need  to
  96. operate on them. This is particularly true in the common case where the display
  97. has only one screen.
  98. However, the following operations on a <#2682#><TT>root</TT><#2682#>
  99. may be useful to an application programmer.<A ID="2683"><tex2html_anchor_invisible_mark></A> 
  100.  
  101. <UL>
  102. <LI>Specify a <#2685#><TT>root</TT><#2685#> as the parent of another contact in order
  103. to create a ``top-level''<A ID="2686"><tex2html_anchor_invisible_mark></A> contact on a specific display screen.
  104. </LI>
  105. <LI>Define actions and event translations for a <#2687#><TT>root</TT><#2687#>
  106. <A NAME="tex2html312" HREF="#footfnm2" TARGET="footer"><SUP>50.2</SUP></A>.  
  107. </LI>
  108. </UL>
  109.  
  110. <P>
  111. The <#2690#><TT>root</TT><#2690#> class is a subclass of the basic <#2691#><TT>composite</TT><#2691#> class,
  112. but <#2692#><TT>root</TT><#2692#>s are different from ordinary composites in several ways.
  113. <A ID="2693"><tex2html_anchor_invisible_mark></A>
  114.  
  115. <UL>
  116. <LI>The parent of a <#2695#><TT>root</TT><#2695#> is <#2696#><TT>nil</TT><#2696#>.
  117. </LI>
  118. <LI>The geometrical attributes of a <#2697#><TT>root</TT><#2697#> cannot be changed.
  119. </LI>
  120. <LI>A <#2698#><TT>root</TT><#2698#> is always created automatically when its
  121. <#2699#><TT>contact-display</TT><#2699#> is created. A <#2700#><TT>root</TT><#2700#> is never created by an
  122. application.
  123. </LI>
  124. <LI>The <#2701#><TT>name</TT><#2701#> of a <#2702#><TT>root</TT><#2702#> is
  125. initialized automatically when it is created.  The initial resource name is <#2703#><TT>:SCREEN-</TT><#2703#><#2704#><EM>n</EM><#2704#>, where <#2705#><EM>n</EM><#2705#> is the index of the
  126. <#2706#><TT>xlib:screen</TT><#2706#> object in <#2707#><TT>(xlib:display-roots
  127. contact-display)</TT><#2707#>~<A NAME="footfnm3"
  128.  HREF="#fnm3" TARGET="footer"><SUP>50.3</SUP></A>.
  129. </LI>
  130. <LI>A <#2709#><TT>root</TT><#2709#> composite imposes no geometry management policy.
  131. </LI>
  132. </TT></UL>
  133.  
  134. <P>
  135.  
  136.  =0 <#5241#>=0 <#5245#>